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The IBM System/360 Model 44 Programming System 
provides functions for input/output operations, 
interruption handling, program phase loading, and 
inter- and intra-program communication. Source 
programs written in the assembler language can 
request these functions directly from the program¬ 
ming system*s supervisor by using the Supervisor 
Call (SVC) instruction. 

This publication contains detailed information 
for coding the assembler language sequences neces¬ 
sary to call these functions. To use this publi¬ 
cation, the programmer should be familiar with the 
functions of the programming system and with the 
assembler language, as described in the following 
IBM publications: 

IBM System/360 Model 44 Programming System: 

C oncepts and Facilities , Form C28-6810 

IBM System/360 Model 44 Programming System: 

Assembler Language , Form C28-6811 
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PREFACE 


This publication supplies detailed 
information for writing the assembler lan¬ 
guage sequences required to use the Super¬ 
visor Call (SVC) functions provided by the 
System/360 Model 44 Programming System. 

The publications cited on the cover 
describe the Model 44 Programming System 
and its assembler language. Machine char¬ 
acteristics of the Model 44 are described 
in the publications: 

IBM System/360: System Summary, Form 
A22-6810 

IBM System/360: Principles of Operation , 
Form A22-6821 

IBM System/360 Model 44: Functional 
Characteristics , Form A22-6875 

Publications on related topics (e.g., 
input/output devices) are listed in the 
publication IBM System/360 Bibliography , 
Form A22-6822. 

Detailed specifications for using the 
system (e.g., coding control statements, 
job deck setup) will be supplied in subse¬ 
quent publications. 


First Edition 


Significant changes or additions to the specifications contained in this 
publication will be reported in subsequent revisions or Technical 
Newsletters. 

This publication was prepared for production using an IBM computer to 
update the text and to control the page and line format. Page 
impressions for photo-offset printing were obtained from an IBM 1403 
Printer with a 120-character chain containing upper and lower case 
letters, special characters, and numerals. 

Copies of this and other IBM publications can be obtained through IBM 
Branch Offices. 

A form for readers' comments appears at the back of this publication. 
It may be mailed directly to IBM. Address any additional comments 
concerning this publication to the IBM Corporation, Programming Systems 
Publications, Department D39, 1271 Avenue of the Americas, New York, 
N.Y. 10020. 

© International Business Machines Corporation 1966 
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INTRODUCTION AND GENERAL INFORMATION 


A supervisor call is a request by a 
problem program for the system to provide a 
specific service. The Model 44 Programming 
System provides several different types of 
services that are available for use by a 
problem program in this manner. 

The system's routines will, for example, 
perform all input/output services for a 
program. They may be used to load other 
programs or program segments from the phase 
library, store information in the user 
communication region, or provide special 
program routines that are entered only when 
and if certain conditions develop. 

The program requests one of these servi¬ 
ces by executing a Supervisor Call (SVC) 
instruction. The assembler instruction SVC 
4 causes the system to read a block of data 
from an input data set. For program clari¬ 
ty, this instruction may be written 

SVC READ 

if, elsewhere in the program, there is the 
assembler instruction 

READ EQU 4. 

The examples in this publication follow 
this format. 

Execution of an SVC instruction causes 
an interruption. The system stops execut¬ 
ing the problem program and branches to a 
supervisor routine that examines the SVC 
operand to determine what service is neing 
requested. It then branches again to one 
of its specialized routines designed to 
provide the requested service. 

The system retains control until the 
request is satisfied, except for 
input/output operations. In the latter 
case, control returns to the problem pro¬ 
gram, unless the program has specified 
otherwise, so that it can continue process¬ 
ing while the input/output operation is in 
progress. The system automatically regains 
control when an input/output interruption 
needs to be processed. 

The program, in a sense, never knows 
that it was interrupted. It picks up 
exactly where it left off when the inter¬ 
ruption occurred, except where specified 
otherwise in the discussions of the indivi¬ 
dual supervisor calls. These discussions 
specify what information the program must 
provide to enable the system to satisfy the 
request and they note what changes are made 


in the contents of the general registers 
and main storage as a result. 


REGISTER CONVENTIONS 


Certain register conventions must be 
observed. Register 1 is used to pass the 
address of a parameter list that contains 
data the system needs to satisfy a problem 
program's request. Register 14 is used for 
return addresses to which certain routines 
must branch when their work is done. Reg¬ 
ister 0 is used in a few cases to pass 
information. 

Execution of any supervisor call des¬ 
troys the contents of register 15. In most 
cases, when the problem program regains 
control, this register contains a return 
code indicating whether the system was able 
to supervisor call properly. This code is 
in the low order byte, and the rest of the 
register is set to zeros. At other times, 
the contents of this register are unpredic¬ 
table. 


NAME CONVENTIONS 


The names of the supervisor calls, such 
as READ, UPSAND, STXITC, are used for 
reference only. They have no special mean¬ 
ing to the assembler or the system. They 
attain meaning only when equated to a 
numeric value and used in a supervisor 
call, as indicated previously. 


GROUPINGS 


The full list of supervisor calls and a 
brief description of each is given in 
Table 1. The supervisor calls are grouped 
for individual discussion in this publica¬ 
tion as follows: 

The input/output section covers 
SVC 0 - SVC 11. These are broken into sub¬ 
groups of OPEN and CLOSE for label 
processing, READ, WRITE, CHECK, NOTE, 
POINT, WEF, REWIND, and UNLOAD for 
input/output operations at the system's 
read/write level, and EXCP and WAIT for 
input/output at the execute channel program 
level. 
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FETCH and LOAD tell how to load and 
enter programs and program segments from 
the phase library. EOJS and CANCEL tell 
how to end a job step or job. 

INSERT, EXTRACT, UPSAND, UPSOR are used 
to store and retrieve information from the 
system's user communication region. 


Timer services are available through use 
of GETIME, SETIME, STXITC, and RTXITC. 
Finally, the discussion of STXIPC and 
RTXIPC tells how a program may handle many 
of its own program check conditions. 


Table 1. Supervisor Calls 

r - T - T -1 


Mnemonic 

| Code 

j Description 

L . _ __ _ . 

EXCP 

i 

jsvc 

1 

1 

0 

I .. ■ ■■ ■ -. . . - --—.- ..■ ■ - 

1 

| EXCP (execute channel program) is used by programs that provide 
j their own input/output routines. 

WAIT 

\ 

j SVC 

1 

1 

1 

1 

| WAIT is used to delay further execution of a program until an EXCP 
j operation has been completed. 

I 

OPEN 

1 

j SVC 

1 

1 

2 

1 

| OPEN is used for tape label processing and repositioning of data 
j sets before the data sets are used in a program. 

i 

CLOSE 

1 

|SVC 

1 

1 

3 

1 

| CLOSE is used for label processing of data sets after they have 
j been used in a program, 

i 

READ 

1 

j SVC 

1 

1 

4 

l 

| READ is used to transmit a block of data from an input data set to 
j an area of main storage. 

I 

WRITE 

1 

| SVC 

1 

3 

5 

1 

| WRITE is used to transmit a block of data from an area of main 
j storage to an output data set. 

1 

CHECK 

1 

|SVC 

1 

j 

6 

1 

| CHECK is used to delay further execution of a program until an 
j input/output operation, other than one initiated by EXCP, has 

j been completed. 

I 

NOTE 

|SVC 

I 

7 

! 

1 NOTE is used to determine the current position of a data set. 

i 

POINT 

I 

| SVC 

1 

8 

1 

| POINT is used to reposition a data set. 

i 

WEF 

1 

| SVC 

1 

1 

9 

1 

| WEF (write end-of-file mark) is used to write an end-of-file mark 
j in an output data set on magnetic tape. 

REWIND 

I 

|SVC 

I 

10 

1 

| REWIND is used to reposition a magnetic tape to its load point. 

I 

UNLOAD 

I 

|SVC 

1 

11 

1 

| UNLOAD is used to rewind and unload a magnetic tape volume. 

FETCH 

1 

j SVC 

1 

1 

12 

1 

| FETCH is used to load a program or program segment into main 
j storage from the phase library and transfer control to it. 

I 

LOAD 

1 

| SVC 

1 

1 

13 

1 

| LOAD is used to load a program or program segment into main storage 
j from the phase library. 

EOJS 

1 

jsvc 

i 

14 

1 

| EOJS (end-of-job step) is used to terminate a job step. 

i 

CANCEL 

1 

jsvc 

1 

15 

1 

| CANCEL is used to terminate a job. 

i 

GETIME 

1 

| SVC 

1 

1 

16 

1 

| GETIME (get time) is used to obtain the time of day from the system 
j timer. 

i 

INSERT 

1 

jsvc 

1 

_J__ 

17 

1 

| INSERT is used to store information in the system's user communi- 
j cation region. 

i .. ... .. __ _ .. . - .. . _ - . . .. __ . 




(continued) 
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Table 1. Supervisor Calls (continued) 
r - T - T - 


h 


Mnemonic 


Code 


Description 


EXTRACT 


UPSAND 


UPSOR 


STXIPC 


STXI'TC 


SETIME 


RTXIPC 


RTXITC 


SVC 18 


SVC 19 


SVC 20 


SVC 21 


SVC 22 


SVC 23 


SVC 24 


SVC 25 


EXTRACT is 
region. 


used to obtain the location of the user communication 


UPSAND (user program switch AND) is used to obtain the logical 
product (AND) of the user program switch byte and the low-order 
byte of register 1. 

UPSOR (user program switch OR) is used to obtain the logical sum 
(OR) of the user program switch byte and the low-order byte of 
register 1. 

STXIPC (set exit for program check interruption) is used to notify 
the system that the program contains a special routine to be 
entered when certain types of program check interruptions occur. 

STXITC (set exit for timer interruption) is used to notify the 
system that the program contains a special routine to be entered 
when a timer interruption occurs. 

SETIME (set interval timer) is used to set a value in the system's 
interval timer. 

RTXIPC (program check interruption return) is used at the end of a 
program check interruption routine to return control to the 
interrupted main program. 

RTXITC (timer interruption return) is used at the end of a timer 
interruption routine to return control to the interrupted main 
program. 
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INPUT/OUTPUT SUPERVISOR CALLS 


There are two levels of input/output 
operations. The first is the read/write 
level in which a problem program invokes 
system routines to perform all input/output 
operations. The system sets up the needed 
instructions, executes the operation, and 
applies standard interruption analysis and 
error recovery techniques. This level pro¬ 
vides device independence in that the same 
problem program coding is used regardless 
of whether the device is a magnetic tape 
unit, direct access storage device, card 
read/punch, or printer. 

The second level is the execute channel 
program (EXCP) level in which the problem 
program provides its own input/output rou¬ 
tines. The EXCP level can be used with 
devices not supported by the system or to 
manipulate devices in a manner not provided 
by the read/write level routines. Device 
routines written and tested at the EXCP 
level may subsequently be incorporated into 
the read/write level through reassembly of 
the supervisor. 

Both levels may be used within a single 
program. 

This section deals in detail with the 
read/write functions before discussing EXCP 
operations. The OPEN and CLOSE supervisor 
calls, which are used for label processing, 
are used at both levels but are discussed 
only in the read/write section,. 


READ/WRITE OPERATIONS 


The read/write level supervisor calls 
are READ, WRITE, NOTE, POINT, CHECK, WEF, 
REWIND, and UNLOAD. A program requiring an 
input/output operation issues one of these 
supervisor calls and provides certain 
information in parameters and control 
blocks so that system routines can execute 
the operation. 

The system uses three types of control 
blocks. They are: 

• Request control blocks, which contain 
general reference information relevant 
to an individual input/output request. 

• File control blocks, which contain 
information pertaining to a particular 
data set and the volume in which it 
resides. 


• Unit control blocks, which contain 
information about a specific input/ 
output device. 


The formats for these blocks are shown 
in the appendix. A problem program at the 
read/write level may refer to the informa¬ 
tion in any of them, but in general it is 
concerned only with the request control 
block. 


The problem program defines a 40-byte 
request control block for each data set 
referred to by its input/output requests. 
The program also must provide one item of 
information within the block, the SYSUNI 
index value in hexadecimal for the system 
unit being used in the operation. This 
value can be obtained from Table 2. The 
system obtains all other information 
required for the block from various sources 
and handles the block's remaining construc¬ 
tion and maintenance. 


One of the parameters accompanying each 
input/output request in a program is the 
address of a request control block. The 
system then uses the information in this 
and other blocks to prepare channel com¬ 
mands, schedule and execute the requested 
operation, analyze the results for errors 
or abnormal conditions, such as end of 
file, and post a return code so the program 
can determine how the operation turned out. 

A return code is saved in the request 
control block until the next time the 
program requests an input/output operation 
using the same block. The system examines 
the code to see how the previous operation 
terminated. If the termination was abnor¬ 
mal, the system places the code in register 
15, resets the code area of the request 
control block to 00, and returns control to 
the problem program. The new request is 
ignored, but since the control block's 
return code area has been cleared, the 
request may be reissued. 

It is up to the problem program to 
decide what to do about the abnormal termi¬ 
nation. Such conditions are noted when the 
system detects a permanent transmission 
error, an end-of-file or end-of-extent 
indication, or an apparently-valid request 
that could not be executed, such as READ 
for a printer. Table 3 contains a list of 
the possible return codes and their mean¬ 
ings. 
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Table 2. System Unit (SYSUNI) Index 
Values 


Table 3. Input/Output Return Codes 

r- T -— 

Hexadecimal 



1 


i 

1 

1 

Code 

(Description | 

System 

1 

Hexadecimal 

i 

Decimal | 

H- 


--+-^ 

Unit 

1 

Code 

i 

Code j 

1 

00 

(Normal return | 


+- 

— 

-+- 

-.) 

1 


i i 

SYSAB1 

1 

1 

01 

i 

1 1 
i 

1 

1 

04 

(Operation dependant: | 

i l 

SYSAB2 

1 

| 

02 

i 

i 

1 

2 I 

1 

1 


1 1 

| a. An end-of-file mark) 


1 


i 

i 

1 


j was detected during thej 

SYSREL 

1 

03 

i 

i 

3 1 

i 

1 


j last READ operation. | 

i i 

SYSLOG 

1 

| 

04 

i 

i 

1 

4 | 

1 

1 


1 1 

| b. An end-of-extent| 


1 


i 

i 

1 


j condition was detected) 

SYSRDR 

1 

05 

i 

5 | 

1 


j during the last WRITEj 


1 


i 

i 

1 


j operation. The dataj 

SYSIPT 

1 

06 

i 

6 1 

1 


j set is positioned justj 


1 


i 

i 

1 


j prior to the block that) 

SYSLST 

1 

07 

i 

i 

7 1 

i 

1 

1 


| causes the overwrite. | 

i i 

SYSOPT 

1 

1 

08 

i 

i 

1 

8 j 

1 

1 

08 

|A permanent transmission! 


1 


i 

i 

1 


| error occurred during the) 

SYSPCH 

1 

09 

i 

9 1 

1 


j last operation. The dataj 


1 


i 

i 

1 


j set is positioned just pastj 

SYSPSD 

1 

0A 

i 

10 | 

1 


j the block containing thej 


1 


i 

i 

1 


j error. j 

SYSDMY 

1 

0B 

i 

11 | 

1 


i i 


1 


i 

i 

1 

OC 

|The last operation was term!-| 

SYSUAS 

1 

OC 

i 

12 | 

1 


j nated without transmitting j 


1 


! 

i 

1 


j any data. The position ofj 


1 

1 

/ 0D 

1 

1 

13 | 

i 

1 

1 


j the data set is not known.j 

i i 

1 

reserved 1 

l 0E 

1 

1 

1 

14 | 

1 

1 

10 

( 1 

(The last operation was termi-| 


1 

I 

1 

1 

1 


j nated because of an invalidj 


1 

f OF 

1 

15 | 

1 


j request, such as a READ j 


i 


1 

1 

1 


j request for a printer. j 

SYSOOO 

1 

10 

1 

16 | 

1 


1 i 


1 


1 

1 

1 

14 

(The last operation was termi-| 

SYS001 

1 

11 

1 

17 | 

1 


j nated with an incorrect] 


1 


1 

1 

1 


j length condition. This] 

SYS002 

1 

12 

1 

18 j 

1 


j applies only to a READ or j 


1 


1 

1 

1 


j WRITE that does not invokej 

• 

1 


1 

1 

1 


j incorrect length suppres-j 

• 

1 


1 

1 

1 


j sion. j 

SYS009 

1 

1 

19 

1 

| 

25 | 

1 

l— 

— 

± J 

SYS010 

1 

1 

1 

1 

1A 

1 

1 

1 

| 

1 

26 | 
i 

i 




SYS015 

1 

1 

1 

1 

IF 

1 

1 

1 

I 

1 

i 

31 | 

1 




SYS016 

1 

1 

1 

20 

1 

1 

l 

1 

32 | 

i 




SYS017 

1 

1 

1 

21 

1 

1 

1 

| 

1 

33 | 

i 

i 




SYS200 

1 

1 

1 

D8 

1 

1 

1 

1 

i 

216 | 
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A program should not attempt to deter¬ 
mine how an operation turned out by looking 
into the control block to examine the code. 
The operation may still be in progress, and 
the code would not have been set, A 
program that must know how an operation 
turned out before it resumes processing can 
invoke the CHECK function. 

When CHECK is invoked, control does not 
return to the problem program until the 
operation has been completed and a return 
code is posted in register 15. The control 
block return code area is cleared, and the 
next request is accepted regardless of 
whether the previous operation terminated 
abnormally. 

The following paragraphs show what con¬ 
siderations are necessary when a program 
makes an input/output request. 

When the supervisor call is issued, the 
system examines register 1 for the address 
of a parameter list. This list contains 
the address of a request control block and 
may also contain, depending on the type of 
operation, the address of an input/output 
buffer and the address of a count of the 
number of bytes to be transmitted. 

The system examines the request control 
block to determine how the last operation 
associated with it terminated. 

• If the last operation terminated nor¬ 
mally (or was followed by a CHECK), the 
system proceeds with processing the new 
request. 

• If the last operation still is in 
progress, the system waits until it 
terminates and has been analyzed before 
proceeding with the new request. 

• If the last operation terminated abnor¬ 
mally (and this condition was not 
detected by a CHECK), the new request 
is ignored. The system places the 
abnormal termination code in register 
15 r resets the control block return 
code area to 00, and returns control to 
the problem program. It is up to the 
problem program to act on the abnormal 
termination condition and determine 
whether the new request should be reis¬ 
sued. 

An abnormal condition code in one 
request control block does not affect oper¬ 
ations using other request control blocks. 
The system treats each block independently, 
even if two or more blocks refer to the 
same data set. 

If the last operation terminated normal¬ 
ly or the request is reissued, the system 
determines whether the required channel and 


device facilities are available. It also 
examines the new request and its parameters 
for errors. 


If the required facilities are free, the 
system continues processing the request. 
If they are in use, the system queues the 
new request and returns control to the 
problem program. The system will automat¬ 
ically resume processing the request when 
the facilities are available for it. 


If the system discovers errors in the 
parameters of the new request, it posts an 
error code in the request control block and 
returns to the problem program. This code 
is detected by the CHECK or by the next 
request using the same block. 


When the required facilities are free 
and the request has reached the top of the 
queue, the system constructs the required 
channel program and starts the operation. 
This channel queue method is designed to 
permit maximum use of all available channel 
facilities while providing the greatest 
amount of overlapped processing. 

Termination of an operation causes an 
input/output interruption that is analyzed 
by the system. Standard error recovery 
methods are applied, when necessary, and a 
return code is posted in the request con¬ 
trol block. 


BLOCKING 


A program must handle its own buffering, 
blocking, and unblocking. All blocks with¬ 
in a data set must be the same length. The 
system's read/write routines transmit one 
block at a time, although a program, when 
reading, may elect to have only a partial 
block put into its buffers. These capabil¬ 
ities are covered in more detail in the 
discussions of each individual supervisor 
call. 

Programs using a 2315 disk cartridge 
obtain greatest efficiency by writing 
blocks that are either one, two, four, or 
eight sectors in length. Calculations of 
block sizes also should note that the 
system uses the first five bytes of each 
sector, when blocks are one sector or less 
in length, for the addresses of the track 
and any alternate track. When blocks are 
more than one sector long, these five-byte 
address fields are written only in the 
first sector for the block. 
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CONTROL CHARACTERS 


A program may specify in its control 
statements that the first byte of each 
block contains a control character for 
physical manipulation of printers and unit 
record devices. This oyte must contain the 
bit configuration for the American Stand¬ 
ards Association code for the desired car¬ 
riage or stacker select operation. 

The proper ASA codes are as follows: 

b (blank) Space one line before print¬ 
ing 

0 Space two lines before print¬ 

ing 

Space three lines before 
printing 

+ Suppress space before print¬ 

ing 


1 

Skip 

to 

channel 

1 

2 

Skip 

to 

channel 

2 

3 

Skip 

to 

channel 

3 

4 

Skip 

to 

channel 

4 

5 

Skip 

to 

channel 

5 

6 

Skip 

to 

channel 

6 

7 

Skip 

to 

channel 

7 

8 

Skip 

to 

channel 

8 

9 

Skip 

to 

channel 

9 

A 

Skip 

to 

channel 

10 

B 

Skip 

to 

channel 

11 

C 

Skip 

to 

channel 

12 


V Select card pocket 1 

W Select card pocket 2 


If the device is one to which the 
characters do not apply, the byte is treat¬ 
ed as part of the data record. 


As an alternative to using one of the 
ASA codes, a program may provide the actual 
command code portion of the channel com¬ 
mand. A program indicates in job control 
statements that it is doing this. In such 
cases, the first byte in the data block is 
used as the first byte of the channel 
command. 


ATTENTION INTERRUPTIONS 


An attention interruption occurs when 
the operator presses the request key on the 
Console Printer Keyboard. This attention 
condition is not recognized immediately if 
it would interfere with the proper func¬ 
tioning of an input/output operation that 
is in progress. The interruption is queued 
until it can be accepted and processed 
without destroying essential information. 


When an attention interruption is recog¬ 
nized at the read/write level, the system 
examines word 2 of the appropriate unit 
control block for the address of a special 
attention input/output block permanently 
resident in main storage. This address is 
moved to word 3 of the unit control block, 
and the system branches to the device 
routine address given in the attention 
input/output block to read the message 
typed on the keyboard. This read operation 
is handled in the same manner as a regular 
READ request. 

A program at the EXCP level must dupli¬ 
cate these functions when an attention 
interruption occurs, or it may ignore the 
interruption by returning control to the 
system in the same manner as for a device 
end interruption. 
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LABEL PROCES SIN G SUPERVISOR CALLS 


The OPEN and CLOSE supervisor calls are 
used to prepare data sets for processing 
and to ensure their proper disposition when 
processing is completed. 

Although the main purpose of OPEN and 
CLOSE is to process labels, they should be 
used even with unlabeled data sets. All 
direct access data sets, for example, con- 
tain block count and extent information 
that must be updated by the system. 

The system routines for executing OPEN 
and CLOSE are present in main storage only 
while needed. They are loaded each time an 
OPEN or CLOSE supervisor call is issued. 
Processing time can be saved by taking 
advantage of their capabilities to open or 
close more than one data set with a single 
supervisor call. 

The applicable codes are: 

OPEN - SVC 2 
CLOSE - SVC 3 


OPEN - SVC 2 


The OPEN supervisor call is used to 
verify or create magnetic tape data set 
header labels and reposition tape, unit 
record, and direct access data sets. 

Each installation may specify when reas¬ 
sembling the system supervisor whether its 
standard is to use volume and data set 
labels on magnetic tapes. If its standard 
is not to use them, OPEN does not check for 
their presence or composition. 

When the standard is to use labels, OPEN 
processes both the volume label and the 
data set header label. All volumes should 
be labeled prior to their use in a problem 
program. If a tape volume is unlabeled, 
any data set on it is treated as unlabeled. 
Direct access volumes must be labeled. 

If an input data set on magnetic tape is 
being opened, the system checks the volume 
and data set header labels against data in 
the program's job control statements. Some 
of this information is entered into the 
file control block for the system unit 
containing the data set for use by the OPEN 
routines. 

For an output data set on tape, the 
system checks the volume label, compares 
the expiration date in the data set header 
label with the current date, and, if 
requested, creates a new data set label. 


Direct access volume and data set labels 
are examined or created by the job control 
processor when it processes the ACCESS or 
ALLOC control statements. 

A data set is repositioned if this 
service is requested in the parameters 
accompanying the supervisor call. 

Labeled magnetic tape data sets are 
repositioned to a point between the end of 
the label and the start of the data set. 

An unlabeled magnetic tape is reposi¬ 
tioned to its load point. 

Repositioning of a direct access data 
set is to the origin of the data set or, in 
the case of a directoried data set, to the 
origin of the desired member. 

When repositioning of a unit record data 
set is requested, the current block count 
in the system unit's file control block is 
reset to 0. 

When OPEN is executed, register 1 must 
contain the address of a parameter list. 
This list consists of one full-word entry 
for each data set to be opened. Each entry 
is aligned on a full-word boundary and 
contains the address of a four-byte control 
information area. The first byte of the 
last entry in the parameter list must 
contain the hexadecimal code 80, indicating 
the end of the list. 

The four bytes of control information 
are specified in hexadecimal as follows: 

CONTRL DC XL4'uurrppcc * 

where 

uu is the SYSUNI index value of the 
system unit containing the data 
set. This value can be obtained 
from Table 3. 

rr =00 if the data set is not to be 
repositioned. 

= 01 if repositioning is wanted. 

pp =00 if an input data set is being 
opened. 

= 01 if an output data set is being 
opened. 

cc is a byte reserved for use by the 
system if a return code is needed 
to notify the program of errors. 

After OPEN has been executed, control 
returns to the instruction following the 
SVC. The low-order byte of register 15 
contains the hexadecimal code 00 if there 
were no errors. If register 15 contains 
04, indicating errors, the cc field for the 
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applicable system unit contains one of the 
following codes: 


Hexa¬ 

decimal 

Co de _ Desc ription 

01 The system cannot find the data 

set. For example, the uu field 

may contain an erroneous entry 
pointing to a system unit for 
which no file or unit control 
blocks exist. The data set is 
not opened. 

02 This code indicates that either a 

volume label or a data set 
header label is missing. It 
appears only when the installa¬ 
tion standard is to use labels 
and the program contains a 
LABEL control statement. 

Information from the LABEL 
statement is entered in the 
system unit's file control 

block, and the absence of 
labels is noted so no attempt 
will be made to verify a label 
when CLOSE is given. For an 
output data set, this code 
indicates the absence of both 
the volume and the header 
label. In either case, the 

data set is opened. 


After returning the error code, the 
system takes no further notice of these 
conditions. 


If a more serious condition is detected, 
such as a permanent read error, the system 
writes a message requesting operator inter¬ 
vention. The operator has the option of 
continuing or cancelling the job. 


Following is an example of the use of 
the OPEN supervisor call. 

This example assumes three data sets are 
to be opened, two input data sets on SYSIPT 
and SYS001 and an output data set on 
SYSOPT. The names of the data sets or data 
set members needed for the program have 
been specified in control statements. 
Repositioning of SYS001 and SYSOPT is 
desired. 

OPEN EQU 2 


LA 1,PARAM 

SVC OPEN 



BAL 

14,ANALYS 


DS 

OF 

PARAM 

DC 

A(CTLIPT) 


DC 

A(CTL001) 


DC 

00 

o 


DC 

AL3(CTLOPT) 

CTLIPT 

DC 

XL4'06000000* 

CTL001 

DC 

XL4'11010000' 

CTLOPT 

DC 

XL4'08010100' 


In this example, the Branch and Link 
(BAL) instruction is given to branch to an 
analysis routine as soon as the system has 
finished executing OPEN. ANALYS is not a 
system routine. It represents a routine 
that should be included in a problem pro¬ 
gram. It examines the return codes, takes 
any necessary action, and returns to the 
main program by branching to the address in 
register 14. 


CLOSE - SVC 3 


The CLOSE supervisor call is used to 
ensure proper disposition of data sets that 
no longer are needed by the program. 

With CLOSE, a program can 

• Verify or create standard trailer 
labels in magnetic tape data sets. 

• Reposition a tape volume, unit record, 
or direct access data set. 

• Disconnect a symbolic unit to protect 
the contents of its data set. 

For a labeled input tape data set, the 
trailer label is verified against header 
label and control statement data. The 
block count in the trailer label is com¬ 
pared with the count of blocks read from it 
by the program, and any discrepency is 
indicated through return codes. 

For an output tape data set, an end-of- 
file mark is written and a trailer label is 
created. 

For an output direct access data set, 
the block count in its label is updated, if 
necessary. This updating is not performed 
physically, however, until the end of the 
job step. If the data set is reopened 
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before the end of the job step, it should 
be closed again. 

Repositioning is the same as for OPEN, 
except that magnetic tapes are rewound to 
load point. 

CLOSE disconnects a data set in the 
sense that the system treats subsequent 
input/output requests for the system unit 
as invalid. A magnetic tape volume, in 
addition, is rewound and unloaded. 

When CLOSE is executed, register 1 must 
contain the address of a parameter list. 
This list consists of one full-word entry, 
aligned on a full-word boundary, for each 
system unit to be closed. Each entry 
contains the address of a four-byte control 
information area. The first byte of the 
last entry contains hexadecimal 80, 
signifying the end of the parameter list. 

The control information for each system 
unit is specified in hexadecimal as fol¬ 
lows : 

CONTRL DC XL4•uurrppcc' 

where 

uu is the SYSUNI index of the system 
unit to be closed. 

rr = 00 if the data set is not to be 
repositioned. 

= 01 if the block counts of direct 
access and unit record data sets 
are to be reset to 0 or a magnetic 
tape is to be rewound to load 
point. 

= 02 if the system unit is to be 
disconnected. A magnetic tape 
also is rewound and unloaded. 

pp = 00 to close an input data set and 
to verify an input trailer label 
on magnetic tape. 

= 01 to close an output data set and 
update a direct access label. 


write an end-of-file mark, or 
create a magnetic tape trailer 
label. 

= 02 if no end-of-file mark is to be 
written, and no label processing 
is desired. 

cc is a byte reserved for use by the 
system if a code is needed to 
identify errors. 

To facilitate device independence, the 
system ignores control codes that do not 
apply to the device being used. 

After CLOSE has been executed, control 
returns to the instruction following the 
SVC. The low-order byte of register 15 
contains the hexadecimal code 00 if there 
were no errors. This code is 04 if any of 
the designated system units could not be 
closed, and the cc field of its control 
word contains one of the following codes: 

Hexa¬ 

decimal 

Code Description 

01 The system cannot find the data 

set. The data set is not 
closed. 

02 Reserved for future use. 

04 An input magnetic tape data set 

contained a standard header 
label but does not contain a 
standard trailer label. The 
data set is closed. 

08 The block count in an input mag¬ 

netic tape data set trailer 
label differs from the count of 
blocks read from it by the 
program. The data set is 
closed. 

If a more serious condition, such as 
permanent write error is detected, a mes¬ 
sage is written, and the operator has the 
option of continuing or canceling the job. 
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READ/WRITE LEVEL SUPERVISOR CALLS 


The five primary input/output supervisor 
calls at the read/write level are READ, 
WRITE, NOTE, POINT, and CHECK. These 
supervisor calls enable a program to read 
and write data, reposition a data set, and 
ensure that a data transmission terminated 
satisfactorily. A general discussion of 
their functioning was given at the begin¬ 
ning of this section. 

The applicable SVC codes are: 

READ - SVC 4 
WRITE - SVC 5 
CHECK - SVC 6 
NOTE - SVC 7 
POINT - SVC 8 

The parameters for each of these super¬ 
visor calls must include the address of a 
request control block. Each request con¬ 
trol block referred to in a program must be 
defined by the program as a 40-byte area. 
The program also must provide the SYSUNI 
index for the system unit involved. This 
is illustrated in the examples accompanying 
the discussion of the individual supervisor 
calls. 


that differs from the block size of the 
input records. The system reads one block 
at a time. If the program specifies a 
count smaller than the block size, only the 
number of bytes specified by the program 
are transmitted. If the count is larger 
than the block size, only one block is 
transmitted. In either case, an incorrect 
length condition occurs. This condition is 
ignored if the xx byte of the count field 
is hexadecimal 20. If the first byte is 
00, an incorrect length code is posted in 
the request block. This causes an abnormal 
condition return the next time an 
input/output request uses this block. 

The following sample coding could be 
used to read a 360-byte block from an input 
data set on system unit SYS004. Any incor¬ 
rect length condition is suppressed. 


READ 

EQU 

4 

SYS004 

EQU 

20 


DS 

OF 

ROB 01 

DC 

AL1(SYS004) 


DC 

3 9X'00 1 

IOBUFF 

DS 

9 OF 


LA 

1,PARAM 


READ - SVC 4 


SVC READ 
BAL 14,ANALYS 


The READ supervisor call is used to 
transmit one block of data from an input 


data set to an area of main storage. 

ANALYS 

BC 

15,CKCOD(15) 

When READ is executed, register 1 must 

CKCOD 

BC 

15,0(14) 

contain the address of a parameter list. 
This list consists of three full words. 


BC 

15,EOF 

each aligned on a full-word boundary. The 
first word contains the address of a 


BC 

15,RDERR 

request control block. The second word 

contains the address of the area in main 


BC 

15,NODTMT 

storage where the input data is to go. The 
third word contains the address of a four- 


BC 

15.IRQST 

byte count field, which also must be 

aligned on a full-word boundary. 

The count field has the format xxOOyyyy, 


DS 

OF 

where xx is an incorrect length suppression 
code and yyyy is a count of the number of 

PARAM 

DC 

A(RCB01) 

bytes to be transmitted. When the read 

request is executed, yyyv bytes are read 


DC 

A(IOBUFF) 

from the input data set into the area 
specified by the second word in the param¬ 


DC 

A(COUNT) 

eter list. 

COUNT 

DC 

X'2000* 

The incorrect length condition occurs 
when the count field specifies a byte count 


DC 

H*360' 
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At the opening of this example, SYS004 
is equated with 20, its SYSUNI index hexa¬ 
decimal value that goes into the first byte 
of the request control block, and the word 
READ is equated with its proper SVC code 4. 
This is done solely for ease in program¬ 
ming. In either case, the actual numeric 
value could be used at the required places 
in the subsequent coding. 

The next steps set up a request control 
block and define an input buffer. The 
addresses of these two areas are the first 
two entries in the parameter list PARAM at 
the bottom of the example. The count field 
is set up to read 360 bytes and a 20 prefix 
to suppress any incorrect length condition. 

The first of the executable instructions 
loads the address of the parameter list 
into register 1. The READ supervisor call 
follows. When the system returns control 
to the problem program, it will branch to 
the ANALYS routine to analyze the return 
code in register 15 to determine how the 
previous input/output operation on the same 
request control block turned out. The 
Branch and Link instruction puts a return 
address in register 14 to facilitate a 
return to this point when the ANALYS rou¬ 
tine is finished. 

ANALYS is not a system routine. It 
represents the sort of error-checking a 
problem program should do. 

The ANALYS routine uses the return code 
in register 15 as an index for another 
branch. If the code is 00, the branch is 
to the next instruction which returns con¬ 
trol to the main program. Otherwise, the 
branch is to one of the specialized rou¬ 
tines provided elsewhere in the program to 
handle each of the four abnormal condi¬ 
tions . 

When the abnormal condition routines are 
entered, register 1 still contains the 
address of the parameter list which con¬ 
tains the address of the request control 
block involved in the abnormally terminated 
operation. The routine may examine this 
and the file control block to determine 
what should be done. 


WRITE - SVC 5 


The WRITE supervisor call is used to 
transmit a block of data from an area of 
main storage to an output data set. 

When WRITE is executed, register 1 must 
contain the address of a parameter list. 
This list consists of three words aligned 
on full-word boundaries. The first word 


contains the address of a request control 
block. The second word contains the 
address in main storage of the block of 
data to be written. The third word con¬ 
tains the address of a four-byte count 
field which must be aligned on a full-word 
boundary. 


The oouht field has the format xxOOyyyy, 
where xx represents an incorrect length 
suppression code, as for READ, and yyyy 
represents, in hexadecimal, the number of 
bytes to be written. 

The incorrect length code applies when 
the program is working with a device that 
has set physical limits. An incorrect 
length condition is created, for example, 
by an attempt to write a block larger than 
80 bytes on a card punch. This condition 
also can be caused by an attempt to write a 
block larger or smaller than other blocks 
in the data set. 

A program may not write outside the 
previously defined limits of a direct 
access data set or data set member. An 
attempt to do this causes an end-of-extent 
abnormal return condition. 

In other respects, WRITE functions and 
is programmed in the same general manner as 
a READ supervisor call. 


CHECK - SVC 6 


The CHECK supervisor call is used to 
delay further execution of a problem pro¬ 
gram until a requested read/write level 
operation has been completed. 

CHECK may be issued at any time follow¬ 
ing any other read/write level supervisor 
call except OPEN and CLOSE. Its parameters 
include the address of the request control 
block used in the requested operation. 
Control does not return to the user until 
all pending operations involving the block 
have been completed. Before returning, the 
system posts the return code for the last 
completed operation in register 15 and 
resets the return code area of the request 
control block to 00 so that another opera¬ 
tion request can be accepted immediately. 

When CHECK is executed, register 1 must 
contain the address of a parameter list. 
This list consists of one word, aligned on 
a full-word boundary, containing the 
address of a request control block. The 
parameter list may be the same list used 
for the operation to which the CHECK 
applies. 
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Control returns to the instruction fol¬ 
lowing the CHECK SVC. Register 15 contains 
00 if no abnormal conditions were detected 
in the operation. A 00 return code also 
appears if the request control block has 
not been used or if it was examined pre¬ 
viously by CHECK and there has been no 
intervening operation. If the current 
operation terminates abnormally, register 
15 contains one of the non-zero return 
codes shown in Table 3. 


Here 

used. 

is an 

example of how CHECK may be 

SYS003 

EQU 

19 

WRITE 

EQU 

5 

CHECK 

EQU 

6 


DS 

OF 

RCB01 

DC 

AL1(SYS003) 


DC 

39X 1 00' 

IOBUFF 

DS 

90F 


LA 

1,PARAM 


SVC 

WRITE 


SVC 

CHECK 


BAL 

14,ANALYS 

ANALYS 

BC 

15,CKCOD(15) 


DS 

OF 

PARAM 

DC 

A(RCB01) 


DC 

A(IOBUFF) 


DC 

A(COUNT) 

COUNT 

DC 

X* 2000* 


DC 

H'360' 

This 
of 360 
SYS003. 

example calls for writing a block 
bytes in the data set on system unit 
The incorrect length condition is 


suppressed. The WRITE supervisor call is 
followed immediately by a CHECK. This 
combination causes the system to delay 
further execution of the program until the 
write operation has been completed and 
analyzed and a return code has been posted 
in register 15. The abnormal return code 


section of the request control block has 
been reset to 00, and the block is ready to 
accept another request. 

This example uses the branch to the 
ANALYS routine to examine the return code 
in register 15, as did the READ example. 

A combination of operations that would 
result in an error code not being examined 
should be avoided. If, for example, the 
three operations, WRITE, WRITE, CHECK, all 
use the same request control block, and the 
first WRITE terminates abnormally, the sec¬ 
ond WRITE is rejected. An error code is 
placed in register 15, and the error sec¬ 
tion of the request control block is 
cleared. When CHECK is issued, the system 
finds no operation in progress and no error 
code in the request control block, so it 
resets register 15 to zero and returns to 
the main program with no indication of the 
abnormal termination. This condition could 
be avoided by using CHECK after each WRITE 
or by entering an analysis routine between 
the second WRITE and CHECK. 


NOTE - SVC 7 


The NOTE supervisor call is used to 
determine the current position of a data 
set. 

NOTE generally is used with the POINT 
supervisor call, SVC 8, for nonsequential 
processing of data sets. NOTE causes the 
system to provide the number of the next 
block within a data set. The number given 
is based on the position of the block 
within the data set or data set member and 
not on the number of blocks that have been 
read or written by the program. 

When NOTE is executed, register 1 must 
contain the address of a parameter list. 
This list consists of two full words 
aligned on full-word boundaries. The first 
word contains the address of a request 
control block. The second word contains 
the address of a four-byte area where the 
system is to place the block count. This 
area also must be aligned on a full-word 
boundary. The count is stored in it as a 
hexadecimal value. Control returns to the 
instruction following the SVC. 

The system determines the block count 
after all pending input/output operations 
for the data set have been completed. 
Control returns to the instruction follow¬ 
ing the SVC. 

Register 15 contains the hexadecimal 
code 00 if no abnormal conditions were 
detected in the request control block. If 
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the previous operation terminated abnormal¬ 
ly and was not checked, the NOTE request is 
ignored and register 15 contains a non-zero 
return code. 


POI NT - S VC 8 


The POINT supervisor call is used to 
reposition a data set to a specified block. 

POINT generally is used with the NOTE 
supervisor call, SVC 7, for nonsequential 
processing of data sets. POINT causes the 
system to reposition a data set to a place 
immediately following a specified block. 
If, for example, a block count of 3 is 
given, the data set is positioned so that 
the next block that would be read by a READ 
request is the fourth block. 

When POINT is executed, register 1 must 
contain the address of a parameter list. 
This list consists of two full words 
aligned on full-word boundaries. The first 
word contains the address of a request 
control block. The second word contains 
the address of a four-byte area which also 
is aligned on a full-word boundary. This 
area contains the desired block count, 
expressed in hexadecimal. 

For example, to reposition a data set so 


that the next 
fourth block 
set member), 

block to be read is the 
within the data set (or data 
the following might be used: 

SYS003 

EQU 

19 

POINT 

EQU 

8 


DS 

OF 

RCB02 

DC 

ALl(SYS003) 


DC 

39X * 00' 


LA 

1,PARAM 


SVC 

POINT 


BAL 

14,ANALYS 

PARAM 

DC 

A (RCB02) 


DC 

A (BLKCT) 

BLKCT 

DC 

F' 3 * 

The 

between 

data set is repositioned to a point 
its third and fourth blocks. Con- 


trol returns to the instruction following 
the SVC. Register 15 contains the hexa¬ 
decimal code 00 if no abnormal conditions 
were noted in the request control block. 
If the previous operation terminated abnor¬ 
mally and was not checked, the POINT 
request is ignored and register 15 contains 
a non-zero return code. 

As an example of using NOTE and POINT 
together, a program may issue a NOTE super¬ 
visor call to determine the current posi¬ 
tion of a data set. The program then 
determines the number of blocks to be 
skipped of backspaced, modifies the block 
count parameter (BLKCT in the previous 
example) accordingly, and issues a POINT 
supervisor call that uses the same paramet¬ 
er list as the NOTE. 


EXTENDED TAPE VOLUME SUPERVISOR CALLS 


The WEF, UNLOAD, and REWIND supervisor 
calls are used by the system's OPEN and 
CLOSE routines. They are available for 
general use, but problem programs should 
use the OPEN and CLOSE supervisor calls to 
obtain the same results. Use of these 
functions instead of OPEN or CLOSE may 
cause accidental loss of data or malfunc¬ 
tioning of system routines in later opera¬ 
tions on the same data sets. They should 
not be used for direct access volumes. 

The applicable codes are: 

WEF - SVC 9 
REWIND - SVC 10 
UNLOAD - SVC 11 


WEF - SVC 9 


The WEF supervisor call is used to write 
an end-of-file mark on magnetic tape 
volumes. 

An end-of-file mark indicates the end of 
a data set. When a program subsequently 
reads this data set and detects this mark, 
an abnormal return condition is recorded in 
the request control block. 

When WEF is executed, register 1 must 
contain the address of a parameter list. 
This list consists of one word, aligned on 
a full word boundary, containing the 
address of a request control block. 

Control returns to the instruction fol¬ 
lowing the SVC. The low-order byte of 
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and 


return 


register 15 contains the hexadecimal code Parameter specifications 

00 if no abnormal conditions were noted in codes are the same as for WEF. 
the request control block. If the previous 
operation terminated abnormally and was not 
checked, register 15 contains a non-zero 
return code and the WEF request is ignored. 

UNLOAD - SVC 11 

R EWIND - SVC 10 

The UNLOAD supervisor call is used to 
rewind and unload a magnetic tape volume. 

The REWIND supervisor call is used to 

reposition a magnetic tape volume to its Parameter specifications and return 

load point. codes are the same as for WEF. 
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EXECUTE CHANNEL PROGRAM 


The execute channel program supervisor 
calls, EXCP and WAIT, are used to initiate 
execution of a problem program's own 
input/output routines. 

The EXCP level permits a program to work 
with devices that are not supported by the 
system and to manipulate devices in ways 
not provided by the read/write level rou¬ 
tines. For a list of supported devices, 

see IBM_ System /360_ Model 44 Programming 

S ystem: _ Concepts and Facilities , Form 

C28-6810. Routines written and tested at 
the EXCP level may subsequently be incorpo¬ 
rated into the system's read/write level 
through reassembly of the supervisor. 

EXCP level operations make use of both 
system and user routines. System routines 
schedule the requested operation and exe¬ 
cute the privileged instructions required 
for input/output. They also handle some of 
the input/output interruptions that do not 
require the attention of an EXCP level 
program. 

At the EXCP level, the problem program 
supplies the channel commands and a device¬ 
dependent routine that performs 
initialization, interruption, and error 
recovery functions. The system enters the 
problem program's device routines in the 
same way that it enters its own at the 
read/write level. The problem program's 
routines communicate with the system 
through control blocks and return codes. 


REQUIREMENTS 


To execute an operation at the EXCP 
level, a problem program should provide: 

• A channel program consisting of one or 
more channel commands 

• A device routine 

• An input/output block 

A channel program consists solely of the 
commands required to execute the desired 
operation. These commands may be con¬ 
structed before the EXCP supervisor call is 
given, or they may be constructed or updat¬ 
ed by the device routine which the system 
enters as part of its execution of the EXCP 
call. 

The system enters the device routine 
first to set up the channel program. The 
same routine is entered again after execu¬ 
tion of the program for interruption analy¬ 


sis and error recovery. This first entry 
is skipped if the channel program was ready 
before the EXCP was issued. 

A device routine is able to determine 
why it was entered by examining byte 0 of 
word 3 of the unit control block for the 
device being used. This byte contains 00 
when the routine is entered to prepare the 
channel program. At the time of the post¬ 
execution entry, this byte contains a non¬ 
zero value to indicate the type of 
interruption. 

A device routine must not contain any 
supervisor calls. It operates in the 
supervisor state and cannot be interrupted. 

Any interruptions that would have occurred 
during its execution, except for machine 
check and certain types of program check, 
are queued and handled later. 

An input/output block consists of the 
first six words of a request control block. 

It replaces the request control block for 
EXCP level operations and must be aligned 
on a full-word boundary. 

The format of the input/output block is 
shown in Figure 1. Its fields are as 
follows: 

Word Byte Description 

0 0 SYSUNI index, supplied by pro¬ 

grammer. (See SYSUNI index 
table. Table 2.) 

0 1-3 Device routine address, sup¬ 

plied by programmer. 

1 4 Post request flag indicating 

in hexadecimal code whether 
the block currently is 
active, supplied by the sys¬ 
tem. 

00 - no operation pending 
01 - operation in progress 

1 5-7 Address of channel command 

list, supplied by the pro¬ 
grammer . 

2 8 Reserved for system use. 

2,3 9-15 Last seven bytes of Channel 

Status Word, supplied by the 
system at interruption time. 

4 16-19 Sense information, supplied by 

the system when a unit check 
condition occurs. 

5 20-23 Four EBCDIC characters to be 

used by the system to locate 
an error recovery program in 
the phase library. This is g 

an optional field supplied ^ 

by the programmer. 
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Word 


r - T -1 

|0 | 1-3 | 

j SYSUNI j Device Routine Address j 0 

I I I 

h-+-*1 

j 4 j 5-7 j 

| Post Requestj Channel Program Address) 1 

I Flag | | 

-+- 4 

j8 j 9-11 | 

I I ! 

| reserved | | 2 

f-- L -Channel Status Word- 

|12-15 | 

I I 

I I 3 

f—-^ 

|16-19 | 

j Sense Data j 4 

I I 

h- i 

|20-23 | 

j Name of interruption analysis program to be loaded j 5 

I I 

L_J 


Figure 1- Input/Output Block Format 


When a block is created, all fields that 
are not filled by the program should be 
defined as hexadecimal zeros. 


EXECUTION 


When the EXCP supervisor call is issued, 
register 1 must contain the address of an 
input/output block. The system examines 
this block to determine whether it contains 
a valid SYSUNI index and the addresses of a 
device routine and channel program. 

If the SYSUNI index specifies a system 
unit for which no unit control block 
exists, control returns with a 04 hexadeci¬ 
mal code in register 15. If the index 
refers to a device that is not operational, 
control returns with a 08 code in register 
15. In either case, the system treats the 
requested operation as completed. 

If the SYSUNI entry is valid but the 
requested channel facilities are busy, the 
system queues the request and returns con¬ 
trol to the problem program. If the EXCP 
is followed by a WAIT supervisor call, the 
system delays further execution of the 
program until the EXCP operation is com¬ 
pleted. 

When the required channel facilities are 
available, the system examines the 
input/output block for a channel program 
address. 


If an address is present, the system 
starts execution of the channel program. 


If there is no channel program address, 
the system places the address of the 
appropriate unit control block in register 
1, the system return address in register 
14, and enters the device routine. When 
the device routine is ready to return 
control to the system, it branches to the 
address in register 14. The addresses in 
registers 1 and 14 must be unchanged when 
the system regains control. 

As indicated previously, the device rou¬ 
tine can determine why it was entered by 
examining byte 0, word 3 of the unit 
control block. This byte at this time 
should contain 00, indicating that the 
device routine was entered to prepare a 
channel program. 

The device routine prepares the channel 
program and places its address in the 
input/output block. It also must identify 
the type of operation being requested by 
putting a return code in register 15. 

Code 04 tells the system the operation 
will keep the device busy but free the 
channel immediately. This might be a seek 
command on a direct access storage device. 

Code 08 means the operation will tie up 
both the channel and the device, as a data 
transmission operation would do. 


Input/Output Supervisor Calls 21 










Code 00 means that no operation is to be 
performed, and the system should treat the 
request as completed. 

The routine returns to the system by 
branching to the address in register 14. 

The operation now is at the same point 
as it would have been if the channel 
program had been prepared in advance. The 
system commences execution. Unless WAIT is 
in effect, control returns to the problem 
program until there is an input/output 
interruption. 


INTERRUPTION PROCESSING 


Execution of an EXCP request may gener¬ 
ate two or more input/output interruptions. 
When each occurs, the system scans the 
Channel Status Word to determine the cause. 
Some conditions, such as channel end not 
accompanied by device end, are handled 
entirely by the system. 

The system re-enters the problem 
program's device routine if the interrup¬ 
tion is one of the following types: 

Typ e UCB Requ e st Flag 

Device End 04 

Program Controlled 08 

Attention 0C 

The UCB request flag is byte 0, word 3 
of the unit control block which now con¬ 
tains one of the non-zero values listed 
above. As before, on entry to the device 
routine, register 1 contains the address of 
the unit control block, and register 14 
contains the system return address. 

The device routine may examine the 

request flag byte to determine the cause of 
the interruption. The three bytes follow¬ 
ing the request flag contain the address of 
the input/output block associated with the 
operation. 

If a device end interruption is accom¬ 
panied by a unit check condition, the 
system stores sense data from the channel 
and unit in word 4 of the input/output 
block. A unit check condition noted at any 
other time causes the system to delay entry 
of the problem program's device routine 
until a device end interruption occurs. 

The Channel Status Word is stored in 
words 2 and 3 of the input/output block. 


A device routine initiates error recov¬ 
ery operations, when necessary, in the same 
manner as a regular request. It places a 
04 or 08 return code in register 15 and 
branches to the address in register 14. As 
before, a 00 return code tells the system 
the operation is finished. 

The system does not permit other 
requests to disturb a volume while error 
recovery procedures are in progress. 

The device routine may keep a special¬ 
ized interruption analysis and error recov¬ 
ery program in the phase library for use 
only when needed. The device routine 
instructs the system to load and enter such 
a program by putting a 0C return code in 
register 15 and branching to the address in 
register 14. Word 5 of the input/output 
block must contain the name of the desired 
program. 

The program name is specified in the 
input/output block as four EBCDIC charac¬ 
ters. This name must be entered in the 
phase library directory in the format 
xxxxbbbb, where xxxx represents the four 
EBCDIC characters and followed by four 
blanks. 

The program is loaded into the transient 
area of main storage. The system treats it 
as a logical extension of the device rou¬ 
tine. It operates in the supervisor state 
and may not issue any supervisor calls. It 
uses the same return codes as a device 
routine and returns to the system through 
the address in register 14. This address 
and the unit control block address in 
register 1 must be unchanged. 

A program controlled interruption dif¬ 
fers from device end in its use of return 
codes. If, after a program controlled 
interruption, the device routine returns to 
the system with a non-zero return code in 
register 15, the system assumes the opera¬ 
tion still is in progress. If the register 
contains the 00 code, the system treats the 
operation as completed. It resets the post 
request flag in the input/output block to 
00, returns control to the problem program, 
and treats the channel and device as free. 

An attention interruption is handled in 
the same manner as device end. 


When EXCP is executed, register 1 must 
contain the address of an input/output 
block, which must be aligned on a full-word 
boundary. Control returns to the instruc- . 

tion following EXCP. The low-order byte of 


EXCP - SVC 0 
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register 15 contains hexadecimal 00 if the 
request was accepted. Register 15 contains 
04 if no unit control block exists for the 
requested SYSUNI, or 08 if the requested 
device is not operational. 


WAIT - SVC 1 


WAIT instructs the system to delay fur¬ 
ther execution of the problem program until 


a requested EXCP operation has been com¬ 
pleted. 


Completion is indicated by a hexadecimal 
00 in the post request flag byte of the 
input/output block. 

When WAIT is executed, register 1 must 
contain the address of the input/output 
block used in the EXCP operation. When the 
operation is completed, control returns to 
the instruction following WAIT. 
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FLOW CONTROL SUPERVISOR CALLS 


The flow control supervisor calls are 
FETCH and LOAD. They are used to load 
programs and program segments from the 
phase library. 


The applicable codes are: 
FETCH - SVC 12 


LOAD - SVC 13 


PHASE LIBRARY 


The phase library is the source of all 
programs and program segments executed 
under system control. Each phase resident 
in this library has been edited into abso¬ 
lute form by the system's linkage editor. 
It represents a segment of code that is to 
be loaded into main storage at one time. 
It may be anything from an entire program 
to a specialized subroutine shared by sev¬ 
eral installation programs. 


The IBM-supplied processors and tran¬ 
sient supervisor functions reside perman¬ 
ently in this library. User-written phases 
(programs and program segments) may reside 
in it permanently or solely for the dura¬ 
tion of a single job. All additions to the 
library, permanent or temporary, are made 
through the linkage editor. 


The library includes a directory that 
contains an entry for each phase currently 
resident in the library. Each entry con¬ 
tains an 8-character EBCDIC name of the 
phase it identifies. (Names of less than 
eight characters are padded on the right 
with blanks.) Directory entries also 
include information on where the phase is 
located in the library, its main storage 
loading address, and its main entry point. 
The system uses this directory information 
to find, load, and enter a phase unless a 
programmer provides an alternate load 
address in his supervisor call parameters. 

FETCH and LOAD are not used to load 
relocatable routines from the module 
library. These are incorporated into a 
program during linkage editing. 


FETCH ~ SVC 12 


The FETCH supervisor call is used to 
load a program or program segment from the 
phase library into main storage and trans¬ 
fer control to it. 


The system uses FETCH to load and enter 
a user program. This user program may then 
invoke FETCH to load and enter phases of a 
program that would not all fit into main 
storage at one time. FETCH might also be 
used when the choice of subsequent phases 
to be loaded depends upon conditions that 
develop during execution of the current 
program phase. FETCH is designed so that 
the calling routine can pass one full word 
of information to the called routine. 


A phase called by FETCH must be loaded 
and entered at the addresses specified in 
its phase library directory entry. If 
other load or entry points are desired, the 
LOAD supervisor call should be used. 


When the FETCH supervisor call is exe¬ 
cuted, register 1 must contain the address 
of a parameter list. This list consists of 
either one or two full words, aligned on 
full-word boundaries. If there are two 
words-, the system assumes the second word 
is a parameter to be passed to the new 
phase. Before the system transfers control 
to this new phase, it places the contents 
of this second word into register 1. 

The first byte of the first word in the 
parameter list is a hexadecimal code, eith¬ 
er 00 or 80. The 00 code tells the system 
the list consists of two words, and the 
second word is to be put into register 1 
for use by the new phase. The 80 code 
indicates that the list consists of only 
one word and there is no information to be 
passed. 

The remaining three bytes of this word 
contain the address of an 8-byte location 
aligned on a full-word boundary elsewhere 
in main storage. This location must con¬ 
tain the name of the desired phase in 
EBCDIC characters. If the name is less 
than eight characters, it must be padded on 
the right with blanks. 

For example, to load and enter a phase 
named PROGNAME, the following coding could 
be used: 
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FETCH 

EQU 

12 


LA 

1,PARAM 


SVC 

FETCH 


DS 

OF 

PARAM 

DC 

X 

00 

o 


DC 

AL3(LOC) 

LOC 

DC 

C'PROGNAME 


The system searches the phase library 
for an entry named PROGNAME, loads it at 
the address specified in its directory 
entry, and enters it at the address speci¬ 
fied in its directory entry. On entry to 
the phase, register 1 contains binary zeros 
since there was no parameter to be passed. 
Register 15 contains the address of the 
entry point. Other registers are 
unchanged. 


If the system is unable to find and load 
the phase correctly, the job is cancelled. 

To load and enter the same phase as in 
the previous example and pass to it the 
address of a parameter list, the following 
coding could be used: 


FETCH 

EQU 

12 


LA 

1,PARAM 


SVC 

FETCH 


DS 

OF 

PARAM 

DC 

A(LOC) 


DC 

A(LIST) 

LOC 

DC 

C'PROGNAME* 

LIST 

(list of parameters or other 
information) 

Since 

the 

first byte of the first word 


in this parameter list is 00, the system 
loads the phase, as before, but changes the 
contents of register 1 before entering it. 
On entry, register 1 contains the address 


of LIST, since this was the second word in 
the parameter list. The values in register 
15 are the same as in the previous example. 
Other registers are unchanged. 


LOAD - SVC 13 


The LOAD supervisor call is used to load 
a program segment from the phase library 
into main storage. 

LOAD causes the system to search the 
phase library directory for an entry for 
the desired phase. Upon finding it, the 
system loads the phase into main storage, 
places the address of its main entry point 
in register 1, and returns control to the 
calling routine. The phase is loaded ei¬ 
ther at the address specified in its direc¬ 
tory entry or at an alternate address 
specified in the parameters accompanying 
the supervisor call. The entry point 
address that is placed in register 1 is 
obtained from the directory entry and is 
modified, if necessary, to reflect any 
change in loading address. 

When the LOAD supervisor call is execut¬ 
ed, register 1 must contain the address of 
a parameter list. This list consists of 
either one or two full words, aligned on 
full-word boundaries. If there is a second 
word, the system assumes the phase is to be 
loaded at an address other than the one 
specified in the phase's directory entry. 
The alternate address must be within the 
problem program area. 

The first byte of the first word in the 
parameter list is a hexadecimal code, ei¬ 
ther 00 or 80. The 00 code tells the 
system the list consists of two words, and 
the second word contains the address of 
another full-word, aligned on a full word 
boundary, that contains the loading 
address. The 80 code indicates that the 
list consists of only one word and the 
phase is to be loaded at the load address 
in its directory entry. 

The remaining three bytes of the first 
word contain the address of an 8-byte 
location elsewhere in main storage. This 
location must be aligned on a full-word 
boundary and must contain the name of the 
desired phase in EBCDIC characters. If the 
name is less than eight characters, it must 
be padded on the right with blanks. 

For example, to load a phase named 
SBRUTINE, the following coding could be 
used: 


Flow Control Supervisor Calls 
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LOAD 

EQU 

13 


LA 

1,PARAM 


SVC 

LOAD 


DS 

OF 

PARAM 

DC 

X 

00 

o 


DC 

AL3(LOC) 

LOC 

DC 

C’SBRUTINE 



• 


The system finds SBRUTINE, loads it at 
the address specified in its directory 
entry, and returns control to the instruc¬ 
tion following the SVC. On return, reg¬ 
ister 1 contains the address of the phase's 
main entry point. The low-order byte of 
register 15 contains the hexadecimal code 
00, indicating no errors. If the system is 
unable to find the name of the desired 
phase in the phase library directory, reg¬ 
ister 15, on return, contains the code 04. 
Other registers are unchanged. 


The same phase could be loaded at a 
different location by use of the following 


coding: 



LOAD 

EQU 

13 


LA 

1,PARAM 


SVC 

LOAD 

PARAM 

DC 

A(LOC) 


DC 

A(ALP) 

LOC 

DC 

C'SBRUTINE' 

ALP 

DC 

Adoading address) 


This sample coding causes the system to 
find the desired phase and load it at the 
alternate address specified at location 
ALP. Control returns, as before, to the 
instruction following the SVC with the 
address of the phase's main entry point in 


register 1. The return codes in register 
15 are the same as in the previous example. 
Other registers are unchanged. 


TERMINATION SUPERVISOR CALLS 


The termination supervisor calls are 
EOJS and CANCEL. They can be used for 
either normal or abnormal termination of 
programs and program segments. 

The applicable codes are: 


EOJS 

- SVC 

14 

CANCEL 

- SVC 

15 


EOJS - SVC 14 


The EOJS supervisor call is used to 
terminate a job step. 

EOJS should be the last instruction in 
every job step. It instructs the system to 
load the job control processor to read 
control statements and commence execution 
of the next job step. The next job step 
may be part of the same program or the 
first job step in a new program. 

A job step is entered by a standard 
linkage, so it also may be terminated by a 
standard return sequence. 

A program should check before issuing 
EOJS to ensure that no input/output opera¬ 
tions are pending. Completion of an 
input/output operation after EOJS has been 
executed could cause malfunctioning of the 
job control processor. 


CANCEL - SVC 15 


The CANCEL supervisor call is used to 
terminate a job. 

When a CANCEL supervisor call is execut¬ 
ed, the system terminates the current job 
immediately. A message for the operator is 
written, and a dump is taken if a dump was 
requested in the job's control statements. 
The system then loads the job control 
processor which reads the system input 
unit, ignoring all statements until a /£ 
end-of-job control statement is detected. 
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COMMUNICATION REGION SUPERVISOR CALLS 


The communication region supervisor Word Byte 

calls are INSERT, EXTRACT, UPSAND, and 6,7 24-31 

UPSOR. They are used for communication 
between a problem program and the system's 
user communication region. 8,9 32-39 

10 40 

The applicable codes are: 


INSERT - 

SVC 

17 

EXTRACT - 

SVC 

18 

UPSAND - 

SVC 

19 

UPSOR 

SVC 

20 


USER COMMUNICATION REGION 


The user communication region is an area 
within the system supervisor that may be 10 42,43 

used both by system programs, such as the 
assembler, and problem programs. Programs 11 44-47 

may read information from this area, but 
must use supervisor calls to insert or 
alter information to avoid accidental des¬ 
truction of system data. 

Its contents are as follows: 


Word Byt e 

0,1 0-4 

2 8-11 

3 12-15 

4 16-19 

5 20-23 


Description 

Date, set by the operator, 

in the form yyddd. 12,13 48-55 

Address of the first byte 
of the problem program 
area. 

Address of the last byte 
available for use by the 
problem program. 

Address of the highest byte 
in the problem program 
area filled by a phase 14-31 56-127 
loaded by means of any 
FETCH or LOAD supervisor 
call. 

Address of the last byte in 
the problem program area 
filled by the most recent 
FETCH or LOAD supervisor 
call. 


Description 

Job name in EBCDIC charac¬ 
ters. 

Job step name in EBCDIC 
characters. 

User program switch byte. 
This byte is set to zeros 
whenever the system reads 
a JOB control statement. 

Highest assembly error sev¬ 
erity. Reset to zero by 
JOB statement. 

00 - Normal. No errors. 
04 - Warning messages 

listed. Execution 
should be success¬ 
ful. 

08 - Error messages list¬ 
ed. Execution may 
fail. 

0C - Severe errors. Exe¬ 
cution impossible. 

10 - Terminal errors. 

Job has been can¬ 
celled. 

Not used. 

User interprogram communi¬ 
cations area. This area 
may be used by one job 
step to preserve informa¬ 
tion for use by a later 
job step. This area is 
set to zeros whenever the 
system reads a JOB con¬ 
trol statement. 

User intraprogram communi¬ 
cations area. This area 
may be used by one job 
step phase to preserve 
information for use by 
another phase within the 
same job step. This area 
is set to zeros whenever 
the system reads an EXEC 
control statement ini¬ 
tiating a new job step. 

Up to six 8-byte EBCDIC 
option parameters from 
the job step EXEC state¬ 
ment are stored here by 
the job control proc¬ 
essor. If less than six 
parameters are stored, 
the area is padded on the 
right with blanks. The 
area is reset to blanks 


Communication Region Supervisor Calls 
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Word Byte Description 

before the beginning of 
the next job step. The 
full 72 bytes of this 
area and the 8-byte 
intraprogram communica¬ 
tion area also are used 
by the system and proc¬ 
essor programs between 
job steps for temporary 
storage of certain con¬ 
trol statements. 

32-35 128-143 Up to 16 bytes of account¬ 
ing information are 
stored here for use by 
installation routines. 
This information, in 
EBCDIC form, is obtained 
from JOB and/or EXEC 
statements. 

36-xx 144-xxx Data generated by installa¬ 
tion accounting routines 
may be stored here. The 
upper limit of the area 
is determined by the 
installation when the 
resident supervisor is 
re-assembled. This field 
is not included in the 
IBM distributed system. 
As distributed, the user 
communication region 

occupies 36 words, bytes 
0-143. 


INSERT ~ SVC 17 


The INSERT supervisor call is used to 
store information in the user communication 
region. 

The system does not require a problem 
program to provide any information in this 
area other than that contained in control 
statements. If a program does use the 
area, however, it should use the INSERT 
supervisor call to reduce the chances of 
accidental destruction of data needed by 
the system. 

It is not necessary to know the location 
of the region to use INSERT. To refer to 
information already stored, the location 
can be determined by use of the EXTRACT 
supervisor call. 

INSERT cannot be used to alter the 
contents of words 0-10, bytes 0-43 of 
the user communication region. 

INSERT cannot be used to modify the user 
communication region permanently. The 
region is reinitialized when the initial 
program load procedure is executed. 


When the INSERT supervisor call is exe¬ 
cuted, register 1 must contain the address 
of a parameter list. This list consists of 
two words aligned on full-word boundaries. 
The first word contains the address in the 
problem program area of the information to 
be stored in the user communication region. 
The second word contains the address of a 
4-byte area containing control information. 


The first byte of control information 
must be hexadecimal 00. The second byte 
gives the number of 4-byte words to be 
stored in the region. The last two bytes 
indicate where in the region the data is to 
be stored. This last location is expressed 
in terms of the word where the system is to 
start storing the information, the first 
word in the region being word 0. 

For example, to store eight bytes of 
data in the intraprogram communications 
area, words 12 and 13, bytes 48 through 55, 
the following coding could be used: 


INSERT 

EQU 

17 


LA 

1,PARAM 


SVC 

INSERT 

PARAM 

DC 

A(LOC) 


DC 

A(CONTRL) 

LOC 

(data to be stored) 


DS 

OF 

CONTRL 

DC 

X 

o 

o 


DC 

ALK2) 


DC 

AL2(12) 


The system stores the eight bytes of 
information at LOC in the intraprogram 
communications area and returns control to 
the instruction following the SVC. The low 
order byte of register 15 contains the 
hexadecimal code 00, indicating no errors. 

If an attempt is made to use INSERT to 
store information outside the communi¬ 
cations region or in words 0-10, nothing 
is stored, and register 15, on return, 
contains the hexadecimal code 04. 

Other registers are unchanged. 
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EXTRACT 


SVC 18 


With UPSOR, if either of the correspond¬ 
ing bits is a 1, the result is a 1, If 
both are 0 f the result is 0. 

The EXTRACT supervisor call is used to 
obtain the location of the communication 

region. These combinations are illustrated in 


the following table: 


EXTRACT 
address of 

causes the system to put the 
byte 0 of the communication 

A 

B 

UPSAND 

UPSOR 

region in 

register 1 and return control to 

1 

1 

1 

1 

the calling 
particular 

program. The address of any 
word or byte within the region 

1 

0 

0 

1 

is obtained 
this value. 

by adding the byte count to 

0 

1 

0 

1 



0 

0 

0 

0 


UPSAND - SVC 19 and UPSOR - SVC 20 


The UPSAND and UPSOR supervisor calls 
are used to set or alter the contents of 
the user program switch byte in the user 
communications region. This byte is used 
for communication between job steps and 
within a job step. 

When UPSAND is used, the logical product 
(AND) of the user program switch byte and 
the low-order byte of register 1 is stored 
in the user program switch byte. 

When UPSOR is used, the logical sum (OR) 
of the user program switch byte and the 
low-order byte of register 1 is stored in 
the user program switch byte. 

When the two bytes are combined by 
either UPSAND or UPSOR, they are matched 
bit for bit. 

With UPSAND, if each of the correspond¬ 
ing bits is a 1, the result is a 1. If 
either is 0, the result is 0. 


When an UPSAND or UPSOR supervisor call 
is executed, register 1 must contain a 
comparison byte in its low-order positions, 
bits 24 through 31. The system alters the 
user program switch byte accordingly and 
returns control to the instruction follow¬ 
ing the SVC. No error codes apply. 

For example, to set the user program 


switch 

coding 

byte 

could 

to all 
be used: 

l's, the following 

UPSOR 

EQU 

20 



IC 

1,MASK 



SVC 

UPSOR 


MASK 

DC 

X' FF* 


As a result of this UPSOR supervisor 
call, byte 40 of the communications region 
is set to 11111111. This byte is reset to 
all 0's when the system reads a JOB control 


statement initiating another job. 
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CONDITIONAL INTERRUPTION SUPERVISOR CALLS 


The primary purpose of the conditional 
interruption supervisor calls is to notify 
the system that the problem program is 

The problem program is able, for exam¬ 
ple, to inform the system that the program 
should be interrupted when a specified time 
interval elapses. A supervisor call gives 
the system the address of the routine that 
is to be entered. When the time runs out, 
the system interrupts the main program and 
enters the special routine. Execution of 
another supervisor call at the end of this 
routine returns control to the main program 
at the point where it was interrupted. 

In addition to timer services, special 
routines can be provided for certain types 
of program check interruptions. Program 
check interruptions occur when the system 
detects a programming error. 

These supervisor calls are in effect 
only during the job step in which they are 
issued. 

The applicable codes are: 


GETIME - 

SVC 

16 

STXIPC - 

SVC 

21 

STXITC - 

SVC 

22 

SETIME - 

SVC 

23 

RTXIPC - 

SVC 

24 

RTXITC - 

SVC 

25 


SAVE AREAS 


program's interruption routine is entered, 
register 15 contains the address of the 
interruption routine, and register 13 con- 
program mode and is subject to the same 
interruptions as the main problem program. 

Words 0 and 2 of the save area are used 
by the system for system information. The 
contents of register 13 are saved in word 
1. Register 14, 15, and 0 through 12 are 
saved, in that order, in words 3 through 
17. The last two words are for the old 
PSW. 

It is possible for a timer interruption 
to occur, for example, while a program 
check interruption routine is being execut¬ 
ed. The program, therefore, must provide 
separate save areas for each type of inter¬ 
ruption that it handles. Otherwise, the 
occurrence of two interruptions at approxi¬ 
mately the same time would destroy data 
needed to return to the interrupted main 
program. 

Save areas and interruption routines 
must be located in the problem program area 
of main storage. Each save area must be 
aligned on a double-word boundary. If the 
problem program specifies a save area 
address that is not in the problem program 
area, the system does not accept the opera¬ 
tion. 


PROGRAM CHECK 


STXIPC ~ SVC 21 


RTXIPC - SVC 24 


A program that provides its own inter¬ 
ruption routines must also provide save 
areas. A save area consists of 20 words 
C80 bytes) where the system can store the 
contents of the interrupted program's 16 
general registers and program status word 
while the special routine is being execut¬ 
ed. This information is restored when 
control returns to the interrupted program 
through execution of another supervisor 
call at the end of the special routine. 

The system stores the contents of the 
interrupted program's registers immediately 
after the interruption occurs. When the 


The STXIPC supervisor call informs the 
system of the addresses of a program's 
program check save area and the entry point 
of its program check interruption routine. 

The RTXIPC supervisor call is used at 
the end of a program check interruption 
routine to restore the registers and return 
control to the interrupted main program. 

A program check interruption occurs when 
the system detects a programming error, # 

such as an incorrect operand, exceptional ^ 

results, such as fixed-point overflow, or a 
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of another 


violation of system or machine restric¬ 
tions. When a program check interruption 
occurs, the system takes one of three 
possible actions: 


1. Cance l. The job is terminated and a 
message to the operator describes the 
reason for termination. 


2. D ump _and_C ancel . A message to the 

operator is written. A listing of the 
contents of all general registers and 
the problem program area of main stor¬ 
age is written, and the job is termi¬ 
nated. This dump must have been 
requested in the job control state¬ 
ments . 

3. Transfe r to _a User Routine. If an 

STXIPC supervisor call has been exe¬ 
cuted prior to the interruption, the 
system can, in many cases, transfer to 
a program check interruption routine 
in the problem program instead of 
terminating the job. This routine is 
able to analyze the cause of the 
program check condition and also has 
the ability to return to the inter¬ 
rupted program. 

The system does not transfer to a user's 
program check routine if the interruption 
is caused by one of the following condi¬ 
tions : 

• Illegal operation code 

• Privileged operation in the problem 
program state 

• Addressing 

In these cases, the system always can¬ 
cels the job. A dump is written if it was 
requested. 

If the interruption was not due to one 
of the foregoing conditions and an STXIPC 
supervisor call has been executed, the 
system stores the contents of the 16 gener¬ 
al registers and PSW in the user *s program 
check save area and enters the user's 
program check interruption routine. This 
routine may examine the registers and PSW 
and correct the program check condition, 
ignore it, or cancel the job. If this 
routine ends with an RTXIPC supervisor 
call, the system returns to the interrupted 
program at the point of interruption. 

When an STXIPC supervisor call is exe¬ 
cuted, register 13 must contain the address 
of the user's program check save area. 
Register 1 must contain the address of the 
entry point of his program check interrup¬ 
tion routine. These addresses can be 


changed only by execution 
STXIPC. 

If the STXIPC specifies a save area 
address that is not within the problem 
program area, the system does not accept 
the operation. Control returns to the 
problem program with a hexadecimal 04 
return code in register 15. If there are 
no errors and the operation is accepted, 
the return code in register 15 is 00. 

If a program check condition develops 
while a program check interruption routine 
is being executed, the job is cancelled. 

STXIPC expires at the end of a job step. 

RTXIPC should be used only in routines 
that are entered because of a program check 
interruption occurring after execution of 
STXIPC. 

When RTXIPC is executed, the system 
loads the general registers with the con¬ 
tents of the user's program check save 
area. Control returns to the interrupted 
program at the point of interruption. 


TIMER SERVICES 


GETIME - 

SVC 

16 

SETIME - 

SVC 

23 

STXITC - 

SVC 

22 

RTXITC - 

SVC 

25 


The system maintains two timer services. 
The first is the time of day, set by the 
operator as part of the initial program 
loading procedure. The second is an inter¬ 
val timer that may be used by a problem 
program to cause interruptions when a 
desired time interval expires. 

The time, in both cases, is expressed in 
units of 1/19200 second. 


TIME OF DAY 


The GETIME supervisor call is used to 
obtain the time of day. Execution of 
GETIME causes the system to place a value 
in register 0. Multiplying this value by 
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19,200 converts it into the number of 
seconds since "midnight.” 


Control returns to the instruction fol¬ 
lowing the GETIME supervisor call. 


INTERVAL TIMER 


The interval timer facility is used by 
the problem program to cause an interrup¬ 
tion after a designated time period 
expires. This timer occupies a 32-bit word 
at location 80 in main storage. 

A program inserts a value in the inter¬ 
val timer with the SETIME supervisor call. 
The value then is reduced every 1/50 or 
1/60 of a second, depending on conditions 
at the individual installation. When the 
system is equipped with the High Resolution 
Timer feature, the value is reduced every 
13 microseconds. 

The interval timer requires 15.5 hours 
to go from its maximum value to 0, An 
external interruption occurs when the value 
changes from positive to negative. If the 
proper supervisor calls have been executed, 
the system enters the problem program* s 
timer interruption routine. Otherwise the 
interruption is ignored. 

A timer interruption routine is not 
entered immediately if the interruption 
occurs while the system is executing a 
routine in which interruptions are masked 
out. The system's input/output routines, 
for example, mask out all interruptions 
except machine check and program check. 
Other types of interruptions occuring dur¬ 
ing such periods are processed when the 
masked routine has been completed. 

Other factors that may delay entry into 
a timer routine are pauses, when the system 
suspends processing pending some operator 
action, and execution of instructions that 
tie up the central processing unit for 
extended periods. 

There are three supervisor calls for use 
with the interval timer. 

SETIME is used to insert a value into 
the timer. 

STXITC is used to notify the system that 
a timer interruption routine should be 
entered when the inserted value expires. 

RTXITC is used at the end of a timer 
interruption routine to return to the 
interrupted program. 


A SETIME supervisor call is ignored 
unless an STXITC supervisor call has been 
executed previously in the job step. The 
value inserted by SETIME must be the number 
of 1/19200 second intervals desired before 
a timer interruption occurs. 


When the SETIME supervisor call is exe¬ 
cuted, register 1 must contain a timer 
value. This value is inserted in the 
interval timer, and control returns to the 
instruction following the SETIME supervisor 
call. This value can be changed at any 
time by means of another SETIME supervisor 
call. An interruption occurs if this value 
changes from positive to negative within 
the job step. 


STXITC informs the system of the 
addresses of a program's timer interruption 
save area and the entry point of its timer 
interruption routine. 


STXITC must be executed before SETIME, 
or SETIME is ignored. 


When an STXITC supervisor call is exe¬ 
cuted, register 1 must contain the address 
of the entry point of the user's timer 
interruption routine. Register 13 must 
contain the address of the user's timer 
interruption save area. Control returns to 
the instruction following the STXITC super¬ 
visor call. 


Register 15 contains the hexadecimal 
code 00 if there were no errors and the 
operation was accepted. A return code of 
04 indicates that the program specified a 
save area address that was not within the 
problem program area and the operation was 
not accepted. 


RTXITC should be used only in timer 
interruption routines. 


When RTXITC is executed, the .system 
restores the general registers from the 
save area. The program status word that 
was stored in the save area becomes the 
current PSW, and control returns to the 
interrupted program. Control returns to 
the point of interruption unless the 
instruction address portion of the old PSW 
has been changed by the timer interruption 
routine. 


No attempt should be made to return to 
the interrupted program by means other than 
this supervisor call. 
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APPENDIX. INPUT/OUTPUT CONTROL BLOCK FORMATS 


This section contains the formats of the 
control blocks used by the system's 
input/output routines at the read/write 
level. 


Wor d Byte Description 

6 25-27 Counters used to keep track 

of number of attempts made 

to recover an error. 


At the read/write level, the file and 
unit control blocks are constructed and 
maintained by the system. The problem 
program must reserve space for the request 
control blocfk and provide the SYSUNI index 
for its first byte. 


28 


Return code 


Operation completed 
End of file or end of 
volume 

08 = Permanent transmission 
error 

No data transmitted 
Invalid request 
Incorrect length 


00 

04 


0C 

10 

14 


REQU EST CONTR O L BLOCK 


The fields of the request control block 
are defined as follows: 

Word Byte Description 

0 0 SYSUNI index number of the 

system unit to be used in 
the input/output operation. 
This value can be deter¬ 
mined from Table 2. 

0 1-3 Address of the device depen¬ 

dent routine to be used to 
set up the channel commands 
and analyze interruptions. 

1 04 Post request flag indicating 

whether the block currently 
is active: 

00 = No operation pending 
01 = Operation in progress 

1 5-7 Address of the first channel 

command required to execute 
the operation. 

2 8 Reserved for system use. 

2,3 9-15 Last seven bytes of Channel 

Status Word, stored when an 
operation is started and 
when an interruption 

occurs. 

4 16-19 Sense information, stored 

when unit check condition 
occurs. 

5 20-23 Name of program to be loaded 

from the phase library when 
necessary for interruption 
analysis. 

6 24 Error recovery code identify¬ 

ing a type of error. 


9* 


9* 


29-31 


32 


33-35 


36 


37-39 


Address of file control block 
being used for this opera¬ 
tion. 

Request code identifying the 
type of operation to be set 
up by a device routine. 


Address of buffer to be 
for transmission. 


used 


Incorrect length control byte 
20 = Suppress incorrect 

length indication 
00 = Check for incorrect 
length 

Number of bytes to be trans¬ 
mitted. 


♦Following completion of an input/output 
operation, the contents of word 9 are 
replaced by the updated data set position 
block count. 


FILE CONTROL BLOCKS 


The file control block for disk units is 
set up as follows: 


Word Byte 
0 0 


Description 
Flag Byte 
01 = Open 
02 = Disconnected 
04 = Modification 
08 = Header checked 
10 = Labeled 
20 = Update VTOC 
40 = Fresh data set 
80 = Standard unit 

Flag byte 

80 = Control character 
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Word 


UNIT CONTROL BLOCK 


Byte Description 

40 = ASA control characters 
20 = Write check 

10 = Ignore (dummy data Fields in the unit control block are 

set) defined as follows: 


0 

2 


Reserved 









Word 

Byte 

Description 

0 

3 


Number of blocks per track 

0 

0,1 

Physical device address 

1 

4-7 


Total number of blocks read 

0 

2 

Device mode 




or written in the data set 



01 

= Burst mode 







02 

= Overrunable byte mode 

2 

8,9 


Logical record length 



03 

= Non-overrunable byte 








mode 

2,3 

10-15 


Seek and search address for 








the current operation 

0 

3 

Type 

of unit 







10 

= 1052 Console Printer- 

4 

16 


Number of block being proc¬ 




Keyboard 




essed 



20 

= 2501 card reader 







21 

= 2540 card reader 

4 

17 


Number of bytes in key area 



28 

= 2520P card punch 




(2311 only) 



29 

= 254OP card punch 







2A 

= 1442P card punch 

4 

18,19 


Maximum number of bytes per 



22 

= 2520 read-punch 




block 



23 

= 1442 read-punch 







30 

= 1403 printer 

5 

20,21 


Block number of first block 



31 

= 1403M7 printer 




of member in a directoried 



32 

= 1443 printer 




data set 



33 

= 1443S printer 







40 

= 2400 magnetic tape 

5,6 

22-21 


Device address of the first 



41 

= 240OH magnetic tape 




record in the data set 



42 

= 2400D magnetic tape 







48 

= 2400T7 magnetic tape 

7 

28-31 


Number of the last block 



49 

= 2400T7C magnetic tape 




written 



50 

= Single disk storage 








drive 

8 

32-35 


Number of blocks reserved for 



51 

= 2311 disk 




this data set. 









1 

4 

Relative chain pointer (e.g.. 







activity, event chain). 

Fields 

in 

the file control block for 





tape 

units 

are the same as for direct 

1 

5 

Channel Scheduler flags 

access devices, except as follows: 



01 

= Device busy 







02 

= Event in progress 







04 

= Attention waiting 

Word 

Byte 


Description 



08 

= Device not ready 

0 

3 


Setting of modifier bits in 



10 

= Retry operation 




channel command, if appli¬ 








cable 

1 

6 

Job control flags 







80 

= Device down 







40 

= System standard as¬ 

2,3 

10-15 


Expiration date of data set 




signment 







20 

= Job control assigned 







10 

= Programmer assigned 

4 

16,17 


Reserved 



08 

= Assigned this step 

5 

20,21 


Current file count, including 

1 

7 

Read/Write flags 




trailer label file marks 



01 

= Volume has been 








mounted 

5,6 

22-27 


Volume identification in 



02 

= Volume label present 




EBCDIC 



04 

= Volume at EOV 

7,8 

28-35 


Data set name in EBCDIC 

2 

8 

Reserved 

Fields for 

the file control block for 

2 

9-11 

Address of input/output block 

other 

• units 

are the same as for tape except 



used when an attention 

that 

bytes 

28- 

-35 are reserved. 



interruption occurs. 
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Word 


3 


3 


4 
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Description 

(applicable only to those 
devices that can signal 
attention.) 

Request flag for device rou- 


Word Byte Description 

the device in terms of the 
cylinder and head positions 
for direct access devices 
and block count for sequen¬ 
tial devices. 


tine 
00 = 

Setup 

5 

20 

Reserved 


04 = 

Device end interrup¬ 
tion 

5 

21-23 

Address of 

channel command 

08 = 
0C = 

Attention interruption 
Program controlled 
interruption 



word area 
the device 

associated with 


13-15 Input/output block address 
associated with this opera¬ 
tion 


6,7 24-31 Permanent and temporary error 

counters set and used by 
the system's device rou¬ 
tines . 


16-19 Current physical position of 



INDEX 


Abnormal termination 26,30,31 
ACCESS statement 12 
Accounting information 27 
ALLOC statement 12 
Alternate load address 25 
ANALYS routine 15,16 
AND, logical 29 
ASA codes 11 
Assembler 27 

Assembler error severity 27 
Attention interruption 11,22 

Block count 12,17,18 
blocking 10 
buffers 10,15,16 

CANCEL SVC 26 
Channel commands 11,20-23 
channel program 20-22 
Channel Status Word 20-22 
CHECK SVC 16 
CLOSE SVC 12-15 
Communication region 27-29 
Conditional interruptions 30-32 
Console printer-keyboard 11 
Control blocks 

File control block 8,12,13,14,16,33-34 
Formats 21,33-34 
Input/Output block 11,20-23 
Request control block 8-19,33 
Unit control block 8,11,20-23,34-35 
Control characters 11 
Conventions, register 5 
Count field 15,16,17 

Device end interruptions 11,22 

device routines 20-23 

Device types 34 

Disk cartridge, 2315 10 

Disk Labels 12-14 

Disk sectors 10 

Dump 26,31 

End of data (/*) statement 26 

End of extent 8,9,13,16,18 

End of file 8,9,13,14,16,18 

End of job (/S) statement 26 

End of Job 26 

End of job step 26 

End of parameter list code 13,24 

End of volume 8,9,13,16,18 

Entry points 25,30,31,32 

EOJS SVC 26 

Error recovery routine 20,22 

Error severity 27 

EXCP SVC 20-23 

EXEC statement 27,28 

Expiration date 12 

EXTRACT SVC 29 


FETCH SVC 24 

File control block 8,12,13,14,16,33,34 

GETIME SVC 31 

High resolution timer 32 

Incorrect length interruption 9,15,16 
Index 36 

Index, SYSUNI 9,12-22 
Initial program load 28,31 
Input/Output 8-23 
Input/Output block 11,20-23 
Input/Output interruptions 5,8-23 
INSERT SVC 28 

Installation accounting routine 27 
Interprogram communications area 27 
Interruption routines, user 30,31,32 
Interruptions 

Attention 11,22 
Conditional 30-32 
Device end 11,22 
Incorrect length 9,15,16 
Input/output 5,8-23 
Machine check 32 
Program check 30,31 
Program controlled 22 
Supervisor Call 5 
Timer 30-32 
Interval timer 30-32 

Intra-program communications area 27 
Invalid request 9 

Job cancellation 26,31 
Job control processor 26,27 
JOB statement 27,28 

Labels 12-14 
LABEL statement 13 
Libraries 
Module 2 4 
Phase 5,22,24,25 
Linkage editor 24 
loading 24-26 
LOAD SVC 25 
Logical AND 29 
Logical OR 29 

Machine check interruption 32 
Masked interruptions 32 
Module library 24 

Non-sequential processing 17,18 
NOTE SVC 17 

OPEN SVC 12-15 
OR, logical 29 

Permanent transmission error 9,13 
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Phase library 5,22,24,25 

POINT SVC 18 

Post request flag 20-23 

Printer carriage code 11 

Privileged operation 31 

Problem program area 24,25,27,28,31 

Program check interruption 30,31 

Program controlled interruption 22 

Program switch byte 27-29 

READ SVC 15 

Read/write level 15,18 
Redundancy error 9,13,20,22 
Register conventions 5 
Repositioning 12-14,18,19 
Request control block 8-19,33 
Request key 11 

Return codes, input/output 5 
REWIND SVC 19 
RTXIPC SVC 30 
RTXITC SVC 31 

Save areas 30-32 
sectors, disk 10 
Sense data 20-22 


SETIME SVC 31 
Stacker, unit record 11 
STXIPC SVC 30 
STXITC SVC 31 

Supervisor call interruptions 5 
Supervisor state 20 
Supervisor, system 5,13,20,27,28 
SYSUNI index 9,12-22 

Termination, job 26,30,31 
Timer Interruptions 30-32 
Time of day 31,32 
Transient area 12,22 

Unit control block 8,11,20-23,34,35 
UNLOAD SVC 19 
UPSAND SVC 29 
UPSOR SVC 29 

User communication region 27-29 
User interruption routines 30-32 
User program switch byte 27-29 

WAIT SVC 20-23 
WEF SVC 18 
WRITE SVC 16 
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